Batch Wizard

[ | | | ]

The Batch Wizard (Pro, Std, Lite) is a powerful new addition to CSE HTML Validator Professional v4.02 and later that helps you quickly validate multiple documents and view the results in a single or multi-page report. You can also use a tool on the targets (such as the template tool) instead of the validator. The Batch Wizard in CSE v4.50 and above can follow links and also adds a link checking tool that lets you check the links of a web site without having to take the time to validate the individual documents. Note that the standard and lite editions do not include the Batch Wizard.

Using the Batch Wizard Directly from the Editor (Pro, Std, Lite)

You can quickly use the Batch Wizard to generate an HTML validation report for the HTML file that you are editing in HTML Validator's integrated editor by choosing Tools->Validate with Batch Wizard or by pressing Shift+F6 in the integrated editor. To validate all the files that are open in the editor that are recognized (by file extension) as checkable documents, select Tools->Validate All with Batch Wizard.

Using the Batch Wizard Standalone (Pro, Std, Lite)

Open the Batch Wizard by running CSE HTML Validator Professional and then choosing Tools->Batch Wizard or pressing F2.
Create a list of targets that you want to process (you can process by validating or by using a tool on the targets). This is called a target list. Targets can be files, URLs, or directories. To add targets, use the Target menu or the context menu for the Target List tab. You can also drag and drop files and directories onto the target list to add them. Duplicate targets that are already in the target list cannot and will not be added again.
When you've added all the targets to the target list, it is recommended that you save the target list (though this is not required). You can do this by choosing File->Save List. You can save the target list in the directory where HTML Validator is installed or in any other directory.
Set up the options by choosing Options->Batch Wizard Options, pressing F4, or using the button on the toolbar.
You can view and/or change the options for the individual targets by viewing an individual target's properties. Do this if you are validating the targets and you want the Batch Wizard to follow the links in a target so that the links are validated too. Again, you may want to save any changes you make by saving the target list.
Start processing the targets in the target list. An easy way to do this is to press the Process List button (or press F6). The processing progress will be displayed in the Batch Progress tab. If you want to abort the processing, you can press the Stop button (or press F7). Depending on where the Batch Wizard is in the processing cycle will determine how long it is until the processing is actually aborted so you may have to wait a few seconds for the processing to stop after you hit the Stop button.
If you used the validator on the targets, you can view the validation or link check report when processing is completed. When completed, the report will open automatically unless you have changed the options to not automatically open the report. If you used another tool, such as the template tool, reports are not generated.
To process the list again, press the Process List button (or press F6) again. To make sure that all targets are processed again, you may first want to choose Target->All Targets->Set Process to Yes.

Notes and Hints

If a username and password is set for a parent URL target and the Batch Wizard is following links, then that same username and password will be used to follow child links if the domain and path of the child links match the domain and path of the parent URL. If, for some reason, the domain and path do not match and the Batch Wizard is not using the username and password to fetch the child links as desired, then checking the Set usernames and passwords when only domains match option in the Editor Options, General 2 tab may correct the problem.
Each directory target can be set to include subdirectories. If a directory target includes subdirectories, an I will be included in the Flags column of the target. You can change whether subdirectories are included in the target or not by selecting the directory target or targets that you want to change, bringing up the context menu, and then selecting Selection->Set I Flag or Selection->Clear I Flag.
When a directory target is processed, the files in the directory that match an HTML file type extension will be processed. If the directory target includes subdirectories, then the files in the subdirectories that match an HTML file type extension will also be processed. The HTML file type extensions that the Batch Wizard recognizes are configurable in the File Types tab of the Editor Options. If a file has no extension, then it will be processed if CSE HTML Validator Professional is configured to assume that files with no extension have an HTML file type. You can configure this in the File Types tab of the Editor Options.
You can exclude targets that begin with certain strings. This lets you exclude certain directories from being processed. You can specify these "exclude" strings in the Target List Options tab of the Batch Wizard.
You can double-click on a file or URL target to open it in the editor or to view its properties. Which action is performed is determined by a Batch Wizard option.
You can select multiple targets at the same time by using the standard multiple file selection technique (using Ctrl and/or Shift when selecting targets). You can also select all targets by pressing Ctrl+A
To delete a target or targets, select the target or targets that you want to delete and hit the Delete key or select Target->Delete.
There is no undo function. If you do something that you want to undo, you will have to manually undo it. For example, if you delete a target that you did not want to delete, you will have to manually add it back to the target list.
You can add a URL to test dynamic web pages like ASP, PHP, and CGI pages. You can also include variables in the URL like in "http://www.test.com/mycgi.cgi?var1=value1&var2=value2". You can even specify an agent in case the document returned by the server is sensitive to the agent. For example, some dynamic URLs may return a different page for Internet Explorer users than for Netscape Communicator users (the server uses the agent to determine what browser is requesting the document). Furthermore, usernames and passwords can also be specified for protected URLs.
In the target list, the Batch Wizard normally displays an icon for directory and file targets (not for URL targets). If a file or directory target is or becomes inaccessible (such as if it is on a network or removable drive that is not currently available), the icon may disappear or not be shown. This is normal behavior.

Advanced

You can manually or automatically (using your own automatic methods) create a target list file that can be loaded into the Batch Wizard if you know the file format for target lists.

Legend

Proc - this column can be 'Yes' or 'No'. Set to 'Yes' to process the target when the target list is processed. Set to 'No' to ignore the target.
Flags - this column gives additional information about the target.
- D - target is a directory
- F - target is a file
- I - for directories: include subdirectories
- L - follow links: when validating, the links in the target will be extracted and validated (with certain exceptions that can be specified) (New v4.50)
- N - never validate: targets will never be validated; only the other tools will ever be used on the target (N flags for URL targets don't make any sense-- it causes the URL to never be validated and another tool can't be used on a URL target either, so if the N flag is set for a URL target, then it will never be processed.)
- P - for URLs: uses a username and password to download the URL. Note that the password used to download the URL is not stored securely in the *.lst file when you save the target list.
- U - target is a URL
Results - This column shows the number of errors, warnings, bad links, and unique misspellings found during the last completed (not aborted) target list processing that used the validator tool (example: 05e,03w,05b,03m for 5 errors, 3 warnings, 5 bad links, and 3 uniquely misspelled words). Note that the number of bad links will always be zero unless link checking is enabled. Furthermore, the displayed number of errors, warnings, bad links, and misspellings is limited to two digits each, making 99 the maximum number that will be displayed. Note also that this column shows the cumulative number of errors, warnings, bad links, and misspellings for all the targets validated under the specific target. For example, if the target is a directory target that resulted in validating ten documents because the ten documents were in the directory, then the number of errors, warnings, bad links, and misspellings is the cumulative number of errors, warnings, bad links, and misspellings for all ten documents. Similarly, for targets where follow links is enabled, the results shown include the cumulative results of all documents followed for that target.

[ Table of Contents ]